package com.woniuxy.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;
/**
 * @Author: linKe
 * @Date: 2021/11/25 19:17
 * @FileName: SwaggerConfiguration
 * @version: 1.0
 * @Description: Swagger风格API文档配置
 * EnableSwagger2  开启swagger
 */
@Configuration
@EnableSwagger2
public class SwaggerConfiguration {
    /**
     * @return  添加摘要信息
     */
    @Bean
    public ApiInfo apiInfo() {
        // 用ApiInfoBuilder进行定制
        return new ApiInfoBuilder()
                // 设置标题
                .title("RBAC权限模块API文档")
                // 描述
                .description("采用restful风格接口")
                // 作者信息
                .contact(new Contact("linKe",null,null))
                // 版本
                .version("1.0")
                .build();
    }

    /**
     * @param apiInfo   api摘要信息
     * @return  创建API
     */
    @Bean
    public Docket docket(ApiInfo apiInfo) {
        return new Docket(DocumentationType.SWAGGER_2)
                // 用来创建该API的基本信息，展示在文档的页面中（自定义展示的信息）
                .apiInfo(apiInfo)
                // 设置哪些接口暴露给Swagger展示
                .select()
                // 扫描指定包中的swagger注解
                .apis(RequestHandlerSelectors.basePackage(
                        "com.woniuxy.controller"))
                .apis(RequestHandlerSelectors.any())
                // 扫描所有 .apis(RequestHandlerSelectors.any())
                .paths(PathSelectors.any())
                .build();
    }
}
